<HTML>
<BODY>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->

<B>MBRTOWC(3)</B>             Libc Functions Manual             <B>MBRTOWC(3)</B>


</PRE>
<H2>NAME</H2><PRE>
     <B>mbrtowc</B> - restartably converts multibyte character to wide character


</PRE>
<H2>SYNOPSIS</H2><PRE>
     <B>#include</B> <B>&lt;wchar.h&gt;</B>

     <I>size_t</I>
     <B>mbrtowc</B> ( <I>wchar_t *  pwc </I>, <I>const char * s</I>,<I>size_t n</I>, <I>mbstate_t * pst</I>);


</PRE>
<H2>DESCRIPTION</H2><PRE>
     If s is a null pointer, the mbrtowc function is equivalent to the call:
     mbrtowc(NULL, "", 1, ps) In this case, the values of the parameters pwc
     and n are ignored.  If s is not a null pointer, the mbrtowc function in-
     spects at most n bytes beginning with the byte pointed to by s to deter-
     mine the number of bytes needed to complete the next multibyte character
     (including any shift sequences). If the function determines that the next
     multibyte character is completed, it determines the value of the corre-
     sponding wide character and then, if pwc is not a null pointer, stores
     that value in the object pointed to by pwc. If the corresponding wide
     character is the null wide character, the resulting state described is
     the initial conversion state.


</PRE>
<H2>RETURN VALUES</H2><PRE>
     The <B>mbrtowc</B>() function returns the first of the following that applies
     (given the current conversion state):
     This function has not been actually implemented. So it will always return -1.

</PRE>
<H2>SEE ALSO</H2><PRE>
     <B>btowc(3)</B>,  <B>wctob(3)</B>,  <B>mbsinit(3)</B>,  <B>mbrlen(3)</B>,  <B>wcrtomb(3)</B>,


</PRE>
<H2>STANDARDS</H2><PRE>
     The <B>mbrtowc</B>() function conforms to ISO 9899: 1990 (``ISO C'').

Libc                              April 7, 2000                               1
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
